Fields: tagged list formats

These fields control the properties of tagged list formats that are defined in the system. By default, these fields are found in the following locations:

■    Content Management > Tagging > Define tagged list formats, then from the Document System toolbar choose New > Tagged List Format (or select an existing tagged list format, then from the toolbar choose Edit).

Tips

■    Tagged list formats are used by ContentTaggedList iParts to format the rendered display of the iPart. You specify the tagged list format to use in the List Format field of the ContentTaggedList configuration.

■    The default tagged list formats shipped with iMIS are always overwritten during upgrades, so the best practice is to create new tagged list formats rather than modifying the default ones. Take care to name your user-created tagged list formats uniquely to prevent iMIS from treating them as standard iMIS tagged list formats during an upgrade. An easy technique to ensure unique naming is to prefix the name with an acronym for your organization, such as "ORGSimpleWithHTML".

■    The format you define here is applied as a display mask to a single item in a ContentTaggedList iPart. This format is repeated once for each item content record in the list rendered from the iPart. The basic elements of a tagged list format are:

□    One or more content record property labels to explain a following content record property value.

□    One or more content record property values.

□    A single link to the content record itself.

□    HTML fragments.

While none of these elements is actually required by the system, at a minimum you should at least insert the link to the content record itself.

■    The content record property values are all read-only values.

■    The tagged list format editor is essentially the HTML editor used for Content Html iParts, with some iMIS-specific toolbar buttons at the right of the bottom toolbar, and a list of embeddable content record properties at the right of the editor.

If you find some features of the HTML editor confusing, you can download the RadEditor user manual from the Telerik Documentation site.

Note: Some features described in this external document have not been enabled for use when defining Content Html iParts or tagged list formats.

Caution! If you use the HTML editor's built-in Image Editor to modify an image that has a transparent background, the transparent background will be replaced by solid black pixels. If you need to edit images that have a transparent background, you should save a copy of the image to your local computer and use your preferred image editing program to modify it. Then upload the new version to iMIS again, overwriting the old version if desired. The easiest way to save a copy of the image to your local computer is to right-click the image shown the Preview area of the Image Editor, and choose Save Picture As.

iMIS Label Manager (toolbar button - red "A")

Edits a content record property value that has been inserted in the editing area in two possible ways:

■    Changes an existing content record property value in the editing area to a different property. You must place your editing cursor somewhere inside the existing property value before clicking this button.

■    Enables you to define a display mask for date-oriented and numeric property values.

Tip: While you can use this toolbar button to insert a new property value, it's much easier to insert new values by using the red A icons in the Content - Properties list.

■    Display Value - Has no effect.

■    Property - Specifies the property value in which the editing cursor is positioned. If you select a different property value from the list, it will replace the property value in which the editing cursor is positioned.

■    Display Format - Specifies a display mask for date-oriented and numeric property values. To view a list of the syntax you can use for the display mask, click View complete list of Date/Time and Number formats.

iMIS Hyperlink Manager (toolbar button - globe and chain)

Creates a link to the content record itself, enabling you to define the anchor text for the link in various ways.

■    Dynamically based on Property - Specifies anchor text that is different for every content record in the rendered ContentTaggedList iPart. The anchor text will be the selected content record property value.

■    Static text - Specifies anchor text that will be the same for every content record in the rendered ContentTaggedList iPart.

■    Display Format - Specifies a display mask for date-oriented and numeric property values if you specify the anchor text to be Dynamically based on Property. To view a list of the syntax you can use for the display mask, click View complete list of Date/Time and Number formats.

iMIS Conditional Display Manager (toolbar button - {…})

Specifies a single conditional display parameter for any element of the tagged list format (property label, property value, link, or HTML fragment). You must select the entire element before clicking this button. When you insert the conditional parameter, the element is surrounded by braces { } to indicate that it is a conditional display block.

To simulate ELSE arguments for the conditional display of an element, you can copy and paste the element inside the a conditional display block to a position immediately following the existing display block, then select the copied element and click this button to create a new conditional display block with a different parameter.

Note: The iMIS Conditional Display Manager is a generic conditional display control shared among several iMIS features. Therefore, you should be careful to choose values that make sense in the context of conditional display of an element in a tagged list format. As a rule, you should use the default values for Data type, Comparison type, and Source. The only value you should change is for the Value drop-down list, to specify the content record property value that you want to ensure is not empty before displaying this element.

Insert 'Members Only' Marker (toolbar button - red key)

Inserts a graphic icon that is conditionally displayed for an item in a rendered ContentTaggedList iPart if the Content is restricted to members checkbox is selected in the Properties section of the corresponding content record.

Insert 'New' Marker (toolbar button - NEW)

Inserts a graphic icon that is conditionally displayed for an item in a rendered ContentTaggedList iPart if the Mark as important until field in the Properties section of the corresponding content record contains a value and that date has not yet passed.

Content - Properties

Lists the content record properties that can be used as elements in the tagged list format. The list of available properties includes all CM user-defined fields (UDFs) that are defined in the system.

■    P icon - Inserts a pre-defined label for the corresponding content record property. You can modify this label after it has been inserted into the editing area.

■    A icon - Inserts a string variable, delimited by brackets [ ], that will display the actual value of the content record property for each item in the rendered ContentTaggedList iPart. You should not directly edit this string, but you can safely delete it or change it by putting the cursor inside the string and clicking the iMIS Label Manager button on the toolbar (the red "A").

Note: The string variable created by the A icon is not a link. To make the rendered replacement text of a string variable be a link (such as making the Title property a link to the actual content record), you must use the iMIS Hyperlink Manager (toolbar button - globe and chain).

Note: If you insert an HTML property value, the rendered ContentTaggedList iPart, displays the full content of all Content Html iParts in the content record, concatenated together with no visible divisions between them.